Partilhar via

az ml run

  • Referência

Nota

Essa referência faz parte da extensão azure-cli-ml para a CLI do Azure (versão 2.0.28 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az ml run . Saiba mais sobre extensões.

Comandos para envio, atualização e monitoramento de execuções.

Comandos

Name Description Tipo Status
az ml run cancel

Cancelar execução.

 Extensão GA
az ml run download-logs

Descarregue ficheiros de registo.

 Extensão GA
az ml run list

A lista é executada.

 Extensão GA
az ml run monitor-logs

Monitore os logs para uma execução existente.

 Extensão GA
az ml run monitor-tensorboard

Monitore uma execução existente usando tensorboard.

 Extensão GA
az ml run show

Mostrar corrida.

 Extensão GA
az ml run submit-hyperdrive

Envie uma varredura de hiperparâmetros usando run config.

 Extensão GA
az ml run submit-pipeline

Envie um pipeline para execução, a partir de um ID de pipeline publicado ou de um arquivo YAML de pipeline.

 Extensão GA
az ml run submit-script

Envie um script para execução.

 Extensão GA
az ml run update

Atualize a execução adicionando tags.

 Extensão GA

az ml run cancel

Cancelar execução.

az ml run cancel --run
                 [--experiment-name]
                 [--output-metadata-file]
                 [--path]
                 [--resource-group]
                 [--subscription-id]
                 [--workspace-name]

Parâmetros Obrigatórios

--run -r

O runId de uma execução de experimento.

Parâmetros Opcionais

--experiment-name -e

Nome do experimento.

--output-metadata-file -t

Forneça um local de arquivo de saída opcional para saída de objeto estruturado.

--path

Caminho para um diretório raiz para executar arquivos de configuração.

Default value: .
--resource-group -g

Nome do grupo de recursos.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az ml run download-logs

Descarregue ficheiros de registo.

az ml run download-logs --output-dir
                        --run
                        [--experiment-name]
                        [--output-metadata-file]
                        [--path]
                        [--resource-group]
                        [--subscription-id]
                        [--workspace-name]

Parâmetros Obrigatórios

--output-dir -d

Diretório de saída para o qual baixar arquivos de log.

--run -r

O runId de uma execução de experimento.

Parâmetros Opcionais

--experiment-name -e

Nome do experimento.

--output-metadata-file -t

Forneça um local de arquivo de saída opcional para saída de objeto estruturado.

--path

Caminho para um diretório raiz para executar arquivos de configuração.

Default value: .
--resource-group -g

Nome do grupo de recursos.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az ml run list

A lista é executada.

az ml run list [--compute-target-name]
               [--experiment-name]
               [--last]
               [--minimal]
               [--output-metadata-file]
               [--parent-run-id]
               [--path]
               [--pipeline-run-id]
               [--resource-group]
               [--status {Completed, Failed, Finalizing, Preparing, Provisioning, Queued, Running, Starting}]
               [--subscription-id]
               [--tags]
               [--workspace-name]

Parâmetros Opcionais

--compute-target-name

O nome do destino de computação.

--experiment-name -e

Nome do experimento.

--last

Procure os N elementos mais recentes.

Default value: 10
--minimal

Sinalizador para fornecer propriedades mínimas para a saída de execução.

Default value: False
--output-metadata-file -t

Forneça um local de arquivo de saída opcional para saída de objeto estruturado.

--parent-run-id

ID de execução pai.

--path

Caminho para um diretório raiz para executar arquivos de configuração.

Default value: .
--pipeline-run-id

ID de execução do pipeline.

--resource-group -g

Nome do grupo de recursos.

--status

Estado da execução.

Valores aceites: Completed, Failed, Finalizing, Preparing, Provisioning, Queued, Running, Starting
--subscription-id

Especifica a ID da assinatura.

--tags

Tags para uma execução com sintaxe 'key[=value]'.

--workspace-name -w

Nome do espaço de trabalho.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az ml run monitor-logs

Monitore os logs para uma execução existente.

az ml run monitor-logs --run
                       [--experiment-name]
                       [--output-metadata-file]
                       [--path]
                       [--resource-group]
                       [--subscription-id]
                       [--workspace-name]

Parâmetros Obrigatórios

--run -r

O runId de uma execução de experimento.

Parâmetros Opcionais

--experiment-name -e

Nome do experimento.

--output-metadata-file -t

Forneça um local de arquivo de saída opcional para saída de objeto estruturado.

--path

Caminho para um diretório raiz para executar arquivos de configuração.

Default value: .
--resource-group -g

Nome do grupo de recursos.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az ml run monitor-tensorboard

Monitore uma execução existente usando tensorboard.

az ml run monitor-tensorboard --run
                              [--experiment-name]
                              [--local-directory]
                              [--output-metadata-file]
                              [--path]
                              [--resource-group]
                              [--subscription-id]
                              [--workspace-name]

Parâmetros Obrigatórios

--run -r

O runId de uma execução de experimento.

Parâmetros Opcionais

--experiment-name -e

Nome do experimento.

--local-directory

Diretório local para preparar arquivos tensorboard que estão sendo monitorados.

--output-metadata-file -t

Forneça um local de arquivo de saída opcional para saída de objeto estruturado.

--path

Caminho para um diretório raiz para executar arquivos de configuração.

Default value: .
--resource-group -g

Nome do grupo de recursos.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az ml run show

Mostrar corrida.

az ml run show --run
               [--experiment-name]
               [--output-metadata-file]
               [--path]
               [--resource-group]
               [--subscription-id]
               [--workspace-name]

Parâmetros Obrigatórios

--run -r

O runId de uma execução de experimento.

Parâmetros Opcionais

--experiment-name -e

Nome do experimento.

--output-metadata-file -t

Forneça um local de arquivo de saída opcional para saída de objeto estruturado.

--path

Caminho para um diretório raiz para executar arquivos de configuração.

Default value: .
--resource-group -g

Nome do grupo de recursos.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az ml run submit-hyperdrive

Envie uma varredura de hiperparâmetros usando run config.

az ml run submit-hyperdrive --hyperdrive-configuration-name
                            [--async]
                            [--conda-dependencies]
                            [--ct]
                            [--experiment-name]
                            [--output-metadata-file]
                            [--path]
                            [--resource-group]
                            [--run-configuration-name]
                            [--source-directory]
                            [--subscription-id]
                            [--workspace-name]
                            [<USER_SCRIPT_AND_ARGUMENTS>]

Parâmetros Obrigatórios

--hyperdrive-configuration-name

O nome completo do arquivo de configuração do hyperdrive. O arquivo deve estar em uma subpasta do diretório especificado pelo parâmetro path.

Parâmetros Opcionais

--async

Desative o streaming de saída.

Default value: False
--conda-dependencies -d

Substitua o arquivo de dependências Conda padrão.

--ct --target

O nome do destino de computação a ser usado para a execução.

--experiment-name -e

Nome do experimento.

--output-metadata-file -t

Forneça um local de arquivo de saída opcional para saída de objeto estruturado.

--path

Caminho para um diretório raiz para executar arquivos de configuração.

Default value: .
--resource-group -g

Nome do grupo de recursos.

--run-configuration-name -c

Nome (sem extensão) de um arquivo de configuração de execução. O arquivo deve estar em uma subpasta do diretório especificado pelo parâmetro path.

--source-directory

Um diretório local contendo arquivos de código-fonte. O padrão é o caminho se o diretório de origem não for fornecido.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho.

<USER_SCRIPT_AND_ARGUMENTS>

A execução enviar argumentos, como nome de script e argumentos de script.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az ml run submit-pipeline

Envie um pipeline para execução, a partir de um ID de pipeline publicado ou de um arquivo YAML de pipeline.

az ml run submit-pipeline [--datapaths]
                          [--experiment-name]
                          [--output-metadata-file]
                          [--output_file]
                          [--parameters]
                          [--path]
                          [--pipeline-id]
                          [--pipeline-yaml]
                          [--resource-group]
                          [--subscription-id]
                          [--workspace-name]

Parâmetros Opcionais

--datapaths -d

Lista separada por vírgulas de pares name=datastore/path para atribuições de parâmetros datapath.

--experiment-name -n

Nome do experimento para envio de execução. Se não for especificado, use o nome do pipeline.

--output-metadata-file -t

Forneça um local de arquivo de saída opcional para saída de objeto estruturado.

--output_file -f

Arquivo para gravar a saída no formato JSON.

--parameters -p

Lista separada por vírgulas de pares name=value para atribuições de parâmetros de pipeline.

--path

Caminho para um diretório raiz para executar arquivos de configuração.

Default value: .
--pipeline-id -i

ID de um pipeline a ser enviado (guid).

--pipeline-yaml -y

YAML que define um pipeline.

--resource-group -g

Nome do grupo de recursos.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az ml run submit-script

Envie um script para execução.

az ml run submit-script [--async]
                        [--conda-dependencies]
                        [--ct]
                        [--experiment-name]
                        [--output-metadata-file]
                        [--path]
                        [--resource-group]
                        [--run-configuration-name]
                        [--source-directory]
                        [--subscription-id]
                        [--workspace-name]
                        [<USER_SCRIPT_AND_ARGUMENTS>]

Parâmetros Opcionais

--async

Desative o streaming de saída.

Default value: False
--conda-dependencies -d

Substitua o arquivo de dependências Conda padrão.

--ct --target

O nome do destino de computação a ser usado para a execução.

--experiment-name -e

Nome do experimento.

--output-metadata-file -t

Forneça um local de arquivo de saída opcional para saída de objeto estruturado.

--path

Caminho para um diretório raiz para executar arquivos de configuração.

Default value: .
--resource-group -g

Nome do grupo de recursos.

--run-configuration-name -c

Nome (sem extensão) de um arquivo de configuração de execução. O arquivo deve estar em uma subpasta do diretório especificado pelo parâmetro path.

--source-directory

Um diretório local contendo arquivos de código-fonte. O padrão é o caminho se o diretório de origem não for fornecido.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho.

<USER_SCRIPT_AND_ARGUMENTS>

A execução enviar argumentos, como nome de script e argumentos de script.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az ml run update

Atualize a execução adicionando tags.

az ml run update --run
                 [--add-tag]
                 [--experiment-name]
                 [--output-metadata-file]
                 [--path]
                 [--resource-group]
                 [--subscription-id]
                 [--workspace-name]

Parâmetros Obrigatórios

--run -r

O runId de uma execução de experimento.

Parâmetros Opcionais

--add-tag

Marque a entitiy com a sintaxe 'key[=value]'.

--experiment-name -e

Nome do experimento.

--output-metadata-file -t

Forneça um local de arquivo de saída opcional para saída de objeto estruturado.

--path

Caminho para um diretório raiz para executar arquivos de configuração.

Default value: .
--resource-group -g

Nome do grupo de recursos.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.